iT邦幫忙

2025 iThome 鐵人賽

DAY 3
0
自我挑戰組

30 天工程師雜學之旅系列 第 3 篇

Kiro-3 用 Kiro Spec 系統打造有脈絡的開發流程 — 規劃到執行全攻略

  • 分享至 

  • xImage
  •  

1. 前言:從 Vibe Coding 到有結構的開發習慣

我當初看到Kiro就躍躍欲試,就是因為它主打的 spec-driven development 概念非常吸引人 —— “思考先於編碼” 的開發流程不是新概念,但在 AI 工具堆裡,Kiro 能讓這流程看起來自然而不是強迫。
今天,就想跟大家聊聊本人實測後對 Kiro Spec 功能的使用體驗與思維流。


2. Spec 是什麼?Kiro 對開發流程的結構化定義

根據 Kiro 官方的說法,**Specs(規格)**是將複雜功能拆解為可執行計畫的核心資產,能幫助你:

  • 把任意概念化想法轉化為結構化的 user stories 和 acceptance criteria
  • 建立包含架構圖與流程圖的設計文件
  • 透過 tasks.md 跟進實作進度與任務拆解
  • 跨 prod-team 提供可追蹤與協作的美好開發體驗

快速入門:

  1. 在 Kiro 側邊欄 Specs 區點擊「+」,或在 chat 面板選擇 Spec 模式
  2. 輸入你的專案目標描述
  3. 跟著 Requirements → Design → Implementation 三階段流程前進

3. 三階段 Workflow 大解析

3.1 Requirements 阶段:從 Prompt 到 structured user-stories

Kiro 會把你的需求轉成 EARS 格式的 user stories,像是:

WHEN a user submits a form with invalid data  
THE SYSTEM SHALL display validation errors next to the relevant fields

這種寫法具備清晰性、可測性與可追蹤性,讓需求靠得住又有用。像 Jira tickets 一樣,這些 markdown 檔也可被 commit 作為 repo 一部分,保留完整思考歷史。

3.2 Design 階段:系統藍圖初見端倪

在你批准需求後,Kiro 會掃描原始碼,生成 design.md,內容包含:

  • 架構概覽
  • 元件與介面定義
  • 資料模型與錯誤處理設計
  • 測試策略與決策依據

這部份讓整體方向一目瞭然,避免寫完一堆 code 卻不知道為何這樣設計。

3.3 Tasks 階段:落實規劃的任務清單

之後進入 tasks.md,Kiro 把設計拆成可點擊啟動的 task,比如:

  • 實作某個 api endpoint
  • 寫測試/文件/health check
  • …等等

每完成一項,它會更新狀態、生成 diff,等待你 review,再繼續下一步。


4. 規格的進化與協作

4.1 Iterative Refinement(規格也會進化)

Kiro 允許你在進行開發時回來調整 requirements.md 或 design.md,並自動同步更新 tasks.md 任務列表,實現 iterative development 還能保持一致性。

4.2 專案分割合作多人協作

若多人分工開發,你可以透過 Splitting SPEC,把 Specs 分析成不同模組(如 UI、核心邏輯、整合測試等),避免多人衝突,也能更靈活維護。

4.3 與外部成果同步

即使你手動完成部分功能,也能讓 Kiro 辨識已完成的內容並更新 task 狀態,避免重工。


5. 外部評論與技術觀察

外部報導也提到 Kiro 的 Spec 方法跳脫「vibe coding」的雜亂,讓想法有脈絡可循,最終產出更穩定、可維護的程式碼(官方介紹)。

TechTarget 評論指出:Kiro 的差異在於提供導向 spec 的工具,讓你可以作「導航員」而不是「放手讓 AI 作最終決定」,強調的是「你主導設計,而不是 prompt 控制一切」。


6. 實戰心得分享

我的規劃流程長這樣:

  1. 開 Spec → 輸入「我要做 XXX 功能」prompt
  2. 审核生成的 Requirements,確保 EARS user stories 覆蓋 edge cases
  3. 审核 Design,確認架構與 components 合理,適時調整
  4. 在 Implementation 階段逐一點擊 task 實作,review diff 再走下一步
  5. 如果中途 scope 更改,隨時回去 refine Specs 並同步更新 task

這樣開發中少了很多補救時間與重工,也讓每一步都有脈絡可追。


7. 圖像說明

  • llm spec
    使用自然語言開始創造新專案/設計/功能
  • task demo
    模組化的工作項目

8. 結語:Specs 讓計劃和執行貼得更近

在我實際用 Spec 做 FastAPI MCP server 這個功能時,最大的感受是——它讓我在「計劃」和「執行」之間沒有斷層。

以前就算腦子裡有規劃,也常常在寫到一半才發現漏了什麼步驟,或者改 scope 時很難同步更新到整個計畫。
用 Kiro Spec 的時候,每個步驟都被拆成 AI agent 能執行的單位,Kiro 會記住完成進度、知道下一步要幹嘛,甚至 scope 改了也能馬上更新任務列表。

對我來說,這種開發方式不只是「AI 幫我寫 code」,更像是「AI 幫我管理專案,還會自己動手幹活」。
下一篇我會用一個完整案例,帶你從第一行需求開始,到最後任務完成,看看 Spec 在實戰中是怎麼運作的。


上一篇
Kiro-2 用 Kiro Hook 一鍵自動化日常任務 — 安裝、設定與實戰技巧
下一篇
Kiro-4 用 Kiro Spec 打造 FastAPI MCP Server — 從需求到實作的真實案例
系列文
30 天工程師雜學之旅 共 30 篇
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言